home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / k8cc_423.zip / NA.DOC < prev    next >
Text File  |  1990-02-18  |  38KB  |  824 lines
  1.      The K8CC North American Contest Logging Program (NA)             
  2.      Version 4.23
  3.   
  4.   
  5.      TABLE OF CONTENTS
  6.   
  7.   
  8.      INTRODUCTION
  9.   
  10.      GETTING STARTED
  11.       Program Capacity
  12.           System Requirements
  13.           Needed files
  14.           Filename conventions
  15.           DOS Clock
  16.           Hard Disk users
  17.           Floppy Disk users
  18.  
  19.      RUNNING THE PROGRAM
  20.           Starting the program
  21.           NA Sprint & NA QSO Party features
  22.           IARU HF Championship features
  23.         ARRL Sweepstakes features
  24.           ARRL 10M/160M & CQ 160M Contest features
  25.           Exiting the program
  26.  
  27.      COMMANDS AND FUNCTION KEYS
  28.           Editing Commands
  29.           Check Sheet Commands
  30.           Multiplier Sheet Commands
  31.           Program Commands
  32.   
  33.      SENDING CW
  34.  
  35.      CONTROLLING A VOICE KEYER FOR SSB
  36.   
  37.      GENERAL INFORMATION
  38.           Multiplier Lists
  39.           Customizing the Help Screen
  40.           Minutes per Multiplier display
  41.           Reference Sheet
  42.           File Conversions and Editing
  43.  
  44.      PAPERWORK
  45.           Logsheets
  46.           Dupe Sheets
  47.           Summary Sheet
  48.   
  49.      MISCELLANEOUS
  50.           Color
  51.           Compatability
  52.           RFI
  53.   
  54.      PROGRAM SUPPORT
  55.   
  56.      REVISION HISTORY
  57.   
  58.      INTRODUCTION
  59.   
  60.      NA is a logging program for the IBM PC and clones, for use in the
  61.      NA Sprint, NA QSO Party, IARU HF Championship, ARRL Sweepstakes, ARRL
  62.      10M & 160M Contests, and the CQ 160M Contest.  It is designed for real-
  63.      time on-line computer logging/duping/checking during the contest, with
  64.      automatic preparation of the log paperwork afterwards.
  65.   
  66.      This program is modeled after the excellent logging program CT,
  67.      written by Ken Wolff, K1EA, for use in the CQ WW, ARRL DX, CQ WPX and
  68.      WAE contests.  Every attempt has been made to utilize his control
  69.      sequences, function keys, modes, etc.  This was not done to plagarize,
  70.      but in the interest of providing the contest community with a
  71.      consistant user interface.  To a large degree, using NA will reinforce
  72.      CT skills, and vice versa.
  73.   
  74.      GETTING STARTED
  75.  
  76.      PROGRAM CAPACITY - NA has the capacity for up to 2619 QSOs.  This
  77.      number is due to limitations of the compiler used to create NA, and
  78.      not due to the 640K memory limits of MS-DOS computers.  This capacity
  79.      is more than sufficient for any Sprint or NAQP log, and for 99% of the
  80.      logs generated for IARU, SS or ARRL 10M.  When the QSO limit is reached,
  81.      NA will not crash, but stops smoothly and exits in the normal manner.
  82.  
  83.      SYSTEM REQUIREMENTS - NA is designed to run on IBM PC-compatible
  84.      computers with a minimum of 512K of memory and at least one disk
  85.      drive.  The video monitor system can be either monochrome, CGA, EGA or
  86.      VGA as NA runs in text mode at all times.  A standard serial port is
  87.      required for NA to key the transmitter on CW.  A standard parallel port
  88.      is required if control of an outboard voice keyer on SSB is desired.
  89.   
  90.      NEEDED FILES - NA is designed to run from a single directory on the
  91.      default drive, either floppy or hard disk.  Copy the necessary files
  92.      from the distribution disk to the selected drive on your system - the
  93.      files which you will need are:
  94.   
  95.      NA.EXE      Executable NA program
  96.      NA.HLP      Help file of commands
  97.      NAS.MLT     Multiplier list for the NA Sprints
  98.      NAQP.MLT    Multiplier list for the NA QSO Parties
  99.      IARU.MLT    Prefix-to-zone lookup for IARU HF Championship
  100.      SS.MLT      Multiplier list for the ARRL Sweepstakes & 160M
  101.      ARRL10.MLT  W/VE multiplier table for ARRL 10M Contest
  102.      CQ160.MLT   W/VE multiplier table for CQ WW 160M Contest
  103.      NA.REF      Reference sheet file (optional)
  104.  
  105.      For the ARRL 10M contest, you will also need a copy of ARRL.CTY from
  106.      the K1EA program CT to count DX multipliers (not supplied).
  107.  
  108.      FILENAME CONVENTIONS - NAME (call it what you like - NAQP88CW,
  109.      FEB1989, etc.) is the base name from which all output files are
  110.      derived.  NAME.NAF is the base file which contains all the log
  111.      entries.  NA will use this file to create the paperwork files for the
  112.      contest entry.  NAME.LOG is the file containing the logsheets for
  113.      entry, NAME.DUP has dupesheets for each band, while NAME.SUM contains
  114.      the summary sheet and multiplier checklist.
  115.   
  116.      DOS CLOCK - NA assumes that the DOS clock/calendar is set for UTC.
  117.      This may be changed in a future release, but for now those of us who
  118.      keep our computer's clocks on Standard Time will have reset them.
  119.   
  120.      HARD DISK USERS - A hard disk is definitely preferred for reasons of
  121.      space and speed.  If you wish to clean off your hard disk after the
  122.      contest (or return the computer to work!), you'll need only copy
  123.      NAME.NAF to a floppy for storage.  All other files can be recreated
  124.      from NAME.NAF.
  125.   
  126.      FLOPPY DISK USERS - Given the QSO limitation of the current version of
  127.      NA, you can run the program from a floppy with little risk of running
  128.      out of space.  NAME.NAF takes 34 bytes per QSO, plus 272 bytes for the
  129.      information sheet and system strings.  It is possible to format a 360K
  130.      floppy with the system files (even under DOS 4.0!), install all of the 
  131.      NA program files and have room for a 2619 QSO log.
  132.   
  133.      STARTING THE PROGRAM
  134.   
  135.      Enter NA at the DOS prompt and press <enter>.  The program will display
  136.      a directory of .NAF files on the default drive, and prompt you for a
  137.      filename.  If the filename you enter already exists ,you will be shown
  138.      the information sheet for that file.  If the filename you enter is a
  139.      new file, you will be shown a blank information sheet to fill in for
  140.      the file you are about to create.  Fill in each entry, or chose a
  141.      selection to fill in each field.
  142.  
  143.      Once all the fields are filled, you may press ctrl-<enter> to load the
  144.      file.  Or, you may decide to abort by pressing <Esc> without wrecking
  145.      anything.
  146.   
  147.      NA will then load the multiplier table for that particular contest,
  148.      load and check the log file, then change to the LOGSHEET screen.
  149.  
  150.      Once in the LOGSHEET screen, set the band using the band-changing keys,
  151.      and start logging contacts.  The first time through the QSO data line,
  152.      either the <tab> key, space bar, or <enter> keys will move the cursor to
  153.      the next field.  Once the end of line has been reached, using the <enter>
  154.      key will attempt to log the completed QSO.  If data is invalid or missing,
  155.      NA will flag the error and move to that field.  However, using the <tab>
  156.      key or space bar will allow you to loop around the fields without error
  157.      checking, then press <enter> to log the QSO.
  158.     
  159.      Data entry in NA is designed to be as flexible as possible, while
  160.      compensating for most operator errors.  The program requires valid data
  161.      in all fields before logging the QSO.  In addition to checking for data
  162.      validity, NA attempts to save the operator work by retrieving data from
  163.      previous QSOs, or establishing defaults for much of the required QSO
  164.      data.  The most obvious time-saver is using 599 or 59 for the received
  165.      RST in the IARU and 10M contests.  Any time NA establishes default data
  166.      entries, you may change the field if necessary by moving to it with the
  167.      <tab> key, then press the <enter> key to log the QSO.
  168.  
  169.      Begin logging by typing in the callsign and hit either <tab> or <enter>
  170.      which moves you to the next field.  If the station in the callsign field
  171.      has been worked on another band, or is a dupe, NA will fill in the
  172.      fields with data from the previous QSO.  You may change these fields if
  173.      you wish by using the <tab> key to move to that field.  If the station
  174.      has not been worked before, fill in the data fields.
  175.  
  176.      NAS/NAQP FEATURES
  177.  
  178.      For the NA Sprint or NAQPs,  NA expects to see a valid NA mult in the
  179.      QTH field.  If the callsign has a VE/VO prefix, or is a North American
  180.      DXCC country (a multiplier!), then NA will put the official prefix for
  181.      that country as a default in the QTH field.  For non-North America
  182.      stations, use "DX" for their QTH.
  183.   
  184.      The prefix-to-country guesser works pretty well, except that I chose
  185.      not to try and identify KG4's which are more likely to be domestic
  186.      than not (although KG4 entered as a QTH counts as Guantanamo). NA will
  187.      catch portables at the start or end of the call, and USA DX prefixes
  188.      (xH, xL and xP) work for A, K, N and W first letters.
  189.  
  190.      IARU HF FEATURES
  191.  
  192.      For the IARU HF Championship, NA will attempt to guess the correct
  193.      ITU zone and points from the prefix in the callsign field.  Many
  194.      countries are contained within multiple ITU zones (ex. PY, VK, USSR),
  195.      so NA will pick the most common zone for that country.
  196.  
  197.      If you enter anything but a valid ITU zone (1 thru 90) in the zone
  198.      data field, NA will assume that the data is a ITU club abbreviation
  199.      and prompt you to press alt-C to add it to the multiplier list.  This
  200.      is only necessary the first time the club is worked.  The ITU club
  201.      abbreviation may be up to four characters long.
  202.  
  203.      Note: NA will not support a mixed mode entry in the IARU HF Championship
  204.      since it would require separate phone & code dupesheets and log
  205.      notations.
  206.  
  207.      ARRL SWEEPSTAKES FEATURES
  208.  
  209.      For the ARRL Sweepstakes, NA expects to see a valid ARRL section in
  210.      the section field.  If the callsign has a VE, xH6, xL7, xP2 or xP4
  211.      prefix, NA will fill in the section as a default in the section field.
  212.  
  213.      ARRL 10M/160M & CQ 160M CONTEST FEATURES
  214.  
  215.      For these contests, NA expects to see a valid W/VE multiplier abbrev-
  216.      iation in the QTH field.  Otherwise, it will check the callsign to
  217.      determine the DX country.  The default RST is automatically inserted, and
  218.      the mult is marked in the log for identification.  QSOs and mults are
  219.      counted separately by mode for 10M, and the bandswitch keys are used to
  220.      change mode between CW & SSB for mixed mode entries.  For 160M, the mode
  221.      is fixed by the Information Sheet.
  222.  
  223.      Note: The CQ 160 Contest counts 5 points for NA DX QSOs, and 10 points
  224.      for non-NA DX QSOs.  NA uses the CQWW Zone info from ARRL.CTY to determine
  225.      the continent for scoring.  Greenland (OX) will score erroneously as non-
  226.      NA (10 points).  This will be fixed in a later version.
  227.  
  228.      EXITING THE PROGRAM
  229.   
  230.      SAVE AND QUIT - The program is exited by pressing alt-Q.  You will
  231.      then be prompted if you wish to write log and dupe files to disk.  It
  232.      is not mandatory to do this immediately after the contest, as NA can
  233.      be restarted later and the program will generate logs and dupe sheets
  234.      from NAME.NAF.
  235.  
  236.      EDITING COMMANDS
  237.   
  238.      These are line editing commands that can be used to edit the log
  239.      data.  If you have used the K1EA program, they will be familiar.
  240.   
  241.      ctrl-A or HOME      Go to beginning of field
  242.      END                 Go to end of data in field
  243.      ctrl-G              Go to QSO number
  244.      ctrl-K              Wipe entire QSO line (only works in non-edit mode)
  245.      ctrl-W              Wipe (delete) everything inside field
  246.      tab or spacebar     Move to next field
  247.      shift-tab           Move to previous field
  248.      del                 Delete character under cursor
  249.      backspace           Delete character to left of cursor
  250.      Return              Log the QSO
  251.      PgUp                Move backwards one screen in log file (10 QSOs)
  252.      PgDn                Move forwards  one screen in log file
  253.   
  254.      Up and down cursor (arrow) keys work as you might expect.  The left and
  255.      right arrow keys are only used to move along the digits in a field, you
  256.      must use the tab key or spacebar to move between fields.  The keyboard
  257.      operates in INSERT mode (as opposed to OVERSTRIKE) at all times in the
  258.      LOGGING SCREEN.
  259.  
  260.      QSOs may be edited at any time by using the PgUp and PgDn keys to move
  261.      forwards and backwards through the log file. To edit a previous QSO,
  262.      simply move up to the QSO and field that you wish to edit with the arrow
  263.      and tab keys.  You may move to a particular QSO from the current QSO line
  264.      by typing the QSO number in the Callsign field and pressing ctrl-G.
  265.      After editing, pressing ctrl-G again will return to the current QSO line.
  266.   
  267.      You will notice that the cursor changes shape as you move off of, and
  268.      return to, the current QSO line.  This is to remind you that you are
  269.      moving into, or out of, edit mode.
  270.   
  271.      CHECK SHEET COMMANDS
  272.   
  273.      The following functions are used in lieu of a check sheet during the
  274.      contest. Type a call or partial call then hit:
  275.   
  276.      F8        Check Partial Call (against all calls worked)
  277.                Calls needed on current band will appear bright.
  278.   
  279.      F9        Check Full Call (current or last) for dupes
  280.   
  281.      F10       Check QTH/IARU zone (current or last) for Multipliers
  282.                (NAQP, IARU and 10M/160M only)
  283.   
  284.      Check Partial (F8) is the only way to go "search and pounce".  When
  285.      you hear a call, just type one or more characters and hit the F8 key.
  286.      Unless you typed a common prefix or just a call area digit, you will
  287.      rarely get more than a few calls to choose from.  Calls which are
  288.      needed on the current band are highlighted, those already worked are
  289.      shown in dark.  You will soon find that you are automatically hitting
  290.      2 characters plus F8 as you tune the band, just as you automatically
  291.      used to glance at the checksheet.  Most people see no time difference
  292.      between this and the paper method.  When you only hear the suffix,
  293.      Check Partial has a big advantage over paper dupe sheets in that you
  294.      won't have to mentally associate a prefix with the suffix, then find
  295.      it on paper.
  296.   
  297.      MULTIPLIER SHEET COMMANDS
  298.   
  299.      alt-A     Think of it as alt - <A>bbreviations
  300.                Display a list of official NA multiplier abbreviations.
  301.                (n/a for IARU)
  302.  
  303.      alt-C     Think of it as alt - <C>lub
  304.                Add a new ITU club abbreviation to the multiplier list
  305.                (IARU only)
  306.  
  307.      alt-M     Think of it as alt - <M>ultipliers
  308.                Display a map of band-mults, needed and worked (NAQP/IARU). In
  309.                the 10M/160M contests, this list is for the current mode.  Press
  310.                any key to return to the Logging Screen. (n/a for Sprints or SS)
  311.   
  312.      alt-N     Think of it as alt - <N>eeded
  313.                Display overall needed mults (NAS/SS), or for current band
  314.                (NAQP/IARU).  Optionally, you may enter a band in the callsign
  315.                field, then press alt-N to display needed mults for that other
  316.                band.  For the 10M/160M contests, alt-N will display needed
  317.                domestic multipliers on the current mode.
  318.  
  319.      PROGRAM COMMANDS
  320.   
  321.      alt-F1    Band down
  322.      or (-)
  323.  
  324.      alt-F2    Band up
  325.      or (+)
  326.  
  327.      alt-D     Toggle AutoDupe ON/OFF
  328.                When enabled, AutoDupe will cause the F6 message (QSO B4) to
  329.                be sent as your exchange in response to the INS key if the QSO
  330.                is a dupe.
  331.  
  332.      alt-H     Think of it as alt - <H>elp
  333.                At any time in the logging screen, this key combination will
  334.                pop up a Help Screen displaying an abbreviated command set.
  335.                Press any key to get back to the Logging Screen.
  336.   
  337.      alt-R     Think of it as alt - <R>eference
  338.                At any time in the Logging Screen, this key combination will
  339.                pop up a reference sheet from the file NA.REF into the multi-
  340.                function window.
  341.  
  342.      SOUND     Enable computer speaker sidetone while sending CW.
  343.  
  344.      NOSOUND   Disable computer speaker sidetone while sending CW.
  345.  
  346.      SAVELOG   Back-up log file to floppy drive a:
  347.                MAKE SURE A GOOD DISK IS IN A: BEFORE ISSUING COMMAND!!!
  348.  
  349.     SENDING CW
  350.  
  351.      NA will send CW in the same manner as the K1EA program by by keying the
  352.      DTR line of COM1 or COM2.  Interface circuits for CT will work with NA.
  353.  
  354.      The circuit needed to key positive keyed radios from COM1 or COM2 is a
  355.      1K resistor from DTR (pin 20 on a DB25, pin 4 on a DB9) to the base of
  356.      an NPN small signal transistor (for example, a 2N4400, 2N3904, etc.).
  357.      The emitter of the transistor and the ground lead of the transmitter
  358.      keying cable are connected to SIGNAL GROUND (pin 7 on a DB25, pin 5 on
  359.      a DB9).  The collector of the transistor is connected to the hot side
  360.      of the transmitter keying cable.
  361.  
  362.      The CW keying speed may be adjusted from 22 to 50 WPM, just like CT.
  363.      The computer's speaker sidetone is enabled by typing SOUND in the call
  364.      field, and disabled by typing NOSOUND in the call field.
  365.  
  366.      The following keys function much like a memory keyer:
  367.  
  368.      INS         (Insert key) Send his call followed by Memory 2 (exchange)
  369.  
  370.      *           Log QSO and send memory #3 (log/QSL/QRZ process)
  371.  
  372.      #           Insert QSO number into Memory #2 for exchange
  373.  
  374.      F1          Send: Memory #1
  375.  
  376.      F2          Send: Memory #2 (assumed to be your exchange)
  377.  
  378.      F3          Send: Memory #3 (assumed to be QRZ message)
  379.  
  380.      F4          Send: Memory #4 (Your CALL taken from Info Sheet)
  381.  
  382.      F5          Send: his call
  383.  
  384.      F6          Send: Memory #6 (assumed to be your QSO B4 message)
  385.  
  386.      F7          Send: QRL QSY de CALL
  387.  
  388.      alt-F9      CW sending speed down by 2 WPM.
  389.  
  390.      alt-F10     CW sending speed up by 2 WPM.
  391.  
  392.      shift-F1    Change CQ message.
  393.  
  394.      shift-F2    Change exchange message.
  395.  
  396.      shift-F3    Change QRZ message.
  397.  
  398.      shift-F4    Change your call message (Does not change the Info Sheet)
  399.  
  400.      shift-F6    Change your QSO B4 message
  401.  
  402.      esc         Stop sending currently in progress.
  403.  
  404.      Note:  If a "#" sign appears within memory #2, NA will insert the current
  405.      QSO number there when sending the exchange.  Information is taken from
  406.      the current QSO line, unless it is on the bottom line of the log area and
  407.      the callsign field is blank.  Under these conditions, NA uses information
  408.      from the previous QSO (assumes a repeat).
  409.  
  410.      CONTROLLING A VOICE KEYER FOR SSB
  411.   
  412.      NA has the capability to trigger four memories of an outboard voice
  413.      keyer through the LPT1 port.  The exact implementation of an interface
  414.      will depend on your particular keyer, but the following should be
  415.      typical:
  416.  
  417.                                   Q1
  418.     LPT1                     ---
  419.                 |  C|----------------- memory 1 sw
  420.          3 -------- 10K --------|B  |
  421.                                    |  E|---
  422.                                  ---    |
  423.                                         |
  424.                                   Q2    |
  425.                              ---    |
  426.                 |  C|---|------------- memory 2 sw
  427.          4 -------- 10K --------|B  |   |
  428.                                    |  E|---o
  429.                                  ---    |
  430.                                         |
  431.                                   Q3    |
  432.                              ---    |
  433.                 |  C|---|------------- memory 3 sw
  434.          5 -------- 10K --------|B  |   |
  435.                                    |  E|---o
  436.                                  ---    |
  437.                                         |
  438.                                   Q4    |
  439.                                  ---    |
  440.                 |  C|---|------------- memory 4 sw
  441.          6 -------- 10K --------|B  |    |
  442.                                    |  E|---o------------- switch common
  443.                                  ---
  444.  
  445.          11 --
  446.               |
  447.               o--------------------------------------- case ground
  448.               |
  449.      25 --
  450.  
  451.      Q1 thru Q4 are four garden-variety NPN transistors (2N4400, 2N3904,
  452.      etc.).  Further details or ideas are are available from K8CC.
  453.   
  454.      The following keys activate the outboard voice keyer:
  455.   
  456.      F1        Send keyer message 1
  457.      F2        Send keyer message 2
  458.      F3        Send keyer message 3 (assumed to be the QSL/QRZ message)
  459.      F4        Send keyer message 4
  460.      *         Log QSO and send keyer message 3 (log/QSL/QRZ process)
  461.   
  462.      To stop the message, you must use the voice keyer controls.
  463.  
  464.      For SSB contests, be sure to select "NONE" for VoiceKeyer on the
  465.      Information Sheet if you do not have a voice keyer interface connected.
  466.  
  467.      GENERAL INFORMATION
  468.  
  469.      MULTIPLIER LISTS - NA uses a unique multiplier file for each contest:
  470.      NAS.MLT (NA Sprints), NAQP.MLT (NA QSO Parties), SS.MLT (ARRL Sweep-
  471.      stakes & 160M), ARRL10.MLT (ARRL Ten Meter Contest), and CQ160.MLT
  472.      (CQ WW 160M Contest).  As provided, these multiplier lists use the
  473.      official USPS two-letter abbreviations for states whenever possible.
  474.      The "official" list of multiplier abbreviations can be displayed during
  475.      normal operation by pressing Alt-A.
  476.  
  477.      You may modify these lists if you prefer to use different abbreviations.
  478.      An abbreviation may be up to four digits long.  Use care in how often
  479.      you edit these files, since previous logs (using the old mult file)
  480.      will no longer score correctly unless you update the QTH entries to
  481.      correspond to the new mult files.  If NA finds an unknown mult when
  482.      loading an existing file, it will put "//" in the mult marking field.
  483.  
  484.      You will note that some of the mult abbreviations have suffixes to help
  485.      the mult finder work - for example:
  486.  
  487.                NWT=VE8
  488.                            PAC=KH6
  489.  
  490.      tells the mult finder to use NWT for the QTH default for a VE8, and
  491.      PAC as the QTH default for a KH6.  Also, for the NAS and NAQP tables
  492.      (which include NA countries), any mult table entry which occurs after
  493.      "4U" is assumed to be a NA country and is also used by the mult finder
  494.      (no "=" necessary).
  495.  
  496.      For the IARU HF Championship, the program generates a table from 01
  497.      to 90 for the IARU zones.  During the file loading process, any new
  498.      mults (IARU member club stations) are added to the table.  The
  499.      program also loads IARU.MLT which is used for the automatic prefix-
  500.      to-zone/points guess routine.  IARU.MLT has the following format:
  501.  
  502.                DL,5,28                   prefix,points,zone
  503.                DU,5,50
  504.                DX,5,50
  505.                EA6,5,37  etc... 
  506.   
  507.      For the DX multipliers in the 10M/160M contests, you must provide a
  508.      copy of the K1EA ARRL.CTY file from a CT disk (not provided with NA).
  509.      Using the CT file was not done to plagerize, but to eliminate the need
  510.      to update and maintain yet another callsign/country table.  The file does
  511.      not need to be modified in any way - NA automatically removes W, VE, KH6
  512.      and KL7.  Be sure that each line in ARRL.CTY is terminated with a ":" or
  513.      ";" after the prefix lists so that it will load accurately.
  514.  
  515.      CUSTOMIZING THE HELP SCREEN - The Help Screen which is displayed by
  516.      alt-H is contained within the file NA.HLP.  This is an ASCII file that
  517.      you may revise to display anything you want by modifying NA.HLP with a
  518.      text editor.  The file limits are 25 lines by 80 columns wide.
  519.  
  520.      MINUTES PER MULTIPLIER DISPLAY - This display is intended to help the
  521.      operator judge the rate vs. multiplier tradeoff in real time, by showing
  522.      the value of a mult (in minutes) based on the current rate and score.
  523.      This display shows the amount of time that you can sit in a pileup to
  524.      work a new multiplier, assuming that you DO eventually work the mult.
  525.      (See N6OP's Contest Cookbook, page 52).
  526.  
  527.      REFERENCE SHEET - If you are like me, you like to refer to last year's
  528.      rates to check on progress.  Rather than having to refer to sheets of
  529.      paper, NA will pop up a mini reference sheet by pressing alt-R.  The
  530.      program looks for an ASCII file NA.REF for its input, using the first
  531.      line for the window and the first 52 digits of the next eight lines
  532.      for whatever you like.  A typical file for total Q milestones per hour
  533.      might look like this:
  534.  
  535.      Hour Milestones:
  536.  
  537.      12z   68    18z  444    00z  873    06z  1209
  538.      13z  112    19z  505    01z  929    07z  1265
  539.      14z  181    20z  567    02z  993    08z  1290
  540.      15z  277    21z  624    03z  1062   09z  1323
  541.      16z  339    22z  711    04z  1117   10z  1363
  542.      17z  396    23z  793    05z  1171   11z  1435
  543.  
  544.      FILE CONVERSIONS AND EDITING - This logging program creates, and
  545.      restarts from, a file called NAME.NAF.  Should you need to edit
  546.      NAME.NAF beyond what is possible in NA, use the provided N2A.EXE
  547.      utility to convert the file to NAME.ASC, which is a sequential ASCII
  548.      file which can be edited with a text editor.
  549.   
  550.      The first eight lines of NAME.ASC contain data for the Information
  551.      Sheet and the keyer memory strings.  It is not recommended that you
  552.      edit this data directly, since it can be easily modified from within
  553.      NA.  The QSO records follow and are of the format:
  554.   
  555.                dd - Contest day
  556.                 b - band index (160m = 0 thru 10m = 5)
  557.              tttt - time
  558.      cccccccccccc - callsign
  559.               ... - Denotes blanks
  560.  
  561.      NASprint:       "ddbttttccccccccccccqqqnnnnnnnnxxxx"
  562.  
  563.                           qqq - qso number
  564.                      nnnnnnnn - name
  565.                          xxxx - QTH
  566.  
  567.      NAQP:           "ddbttttcccccccccccc...nnnnnnnnxxxx"
  568.  
  569.                      nnnnnnnn - name
  570.                          xxxx - QTH
  571.  
  572.      IARU HF:        "ddbttttccccccccccccqqq........xxxx"
  573.  
  574.                           qqq - rcvd RST
  575.                          xxxx - ITU Zone or Club
  576.  
  577.  
  578.      ARRL SS:        "ddbttttqqqqpcccccccccccckkxxxx...."
  579.  
  580.                          qqqq - qso number
  581.                             p - rcvd precedence
  582.                            kk - rcvd check
  583.                          xxxx - ARRL section
  584.  
  585.      ARRL 10M:       "ddmttttccccccccccccRSTxxxx........"
  586.      ARRL 160M
  587.      CQ 160M              RST - rcvd RST  
  588.                          xxxx - QTH
  589.  
  590.      Do not remove the quote marks as they are used as delimiters.
  591.  
  592.      Once you are done editing the file, use the provided A2N.EXE utility
  593.      to convert NAME.ASC back to NAME.NAF.  Before doing any of these 
  594.      conversions, it is recommended that you copy your .NAF file to another
  595.      file (.OLD for example) just to be safe.
  596.   
  597.      PAPERWORK
  598.   
  599.      LOGSHEET - NA produces a single chronological log of the contest,
  600.      suitable for submission, in the form of a MS-DOS file called NAME.LOG.
  601.   
  602.      DUPE SHEETS - NA will produce a dupesheets which are in a MS-DOS file
  603.      called NAME.DUP for the individual bands or modes.  This file uses the
  604.      standard Epson control codes (not escape codes) for compressed print
  605.      If your printer doesn't support this, you will get lines that wrap
  606.      around and are hard to read.  If problems arise, these codes can be
  607.      removed from the output files with a text editor, but you'll have to
  608.      figure out how to format the pages without them yourself.
  609.    
  610.      SUMMARY SHEET - NA will produce a summary sheet in the form of a MS-DOS
  611.      file called NAME.SUM.  This file uses the standard Epson control codes
  612.      (not escape codes) for double-wide print of the summary sheet title.  If
  613.      problems arise, this code can be removed with a text editor.  The summary
  614.      sheet file also includes a list of all multipliers worked.
  615.   
  616.      MISCELLANEOUS
  617.   
  618.      COMPATABILITY - NA has been tested on real IBM PCs and ATs, AT&T 6300,
  619.      all sorts of XT and AT clones up to 20 MHz, and an IBM PS/2 Model 80
  620.      screaming along at 20 MHz.  This testing included computers with a
  621.      variety of CGA, EGA, VGA and monochrome video displays. The program has
  622.      not been tested on LCD displays, or non-standard text systems.  NA does
  623.      not use any funny calls or manipulations of the display hardware, so you
  624.      should not have any problems making it run.
  625.   
  626.      COLOR - You can force the program to use a color display in black and
  627.      white by using the switch -m in the command line which starts NA.  For
  628.      example: NA -m <enter> starts NA in mono mode. Note that this does not
  629.      reset the display hardware, but causes NA to choose colors which should
  630.      produce readable displays on an MS-DOS computer.  The -m switch will be
  631.      necessary for AT&T 6300 owners and those using composite monochrome
  632.      monitors with CGA cards.
  633.  
  634.      RFI - One potential trouble spot for using this or any other logging
  635.      program in real time on-the-air is RF emissions from your computer
  636.      causing trash in your radio.  This trash usually takes the form of 
  637.      seemingly random carriers (birdies) at certain frequencies, or else a
  638.      broadband noise similiar to a hiss across the entire band.  These noises
  639.      are coming from your MS-DOS computer, and are not unique to any program.
  640.  
  641.      At K8CC, I can only hear this trash when the band is dead or if the
  642.      antenna is disconnected so it is not of any operational consequence.
  643.      One recommendation which I urge is to avoid the use of a flip-top case
  644.      on your computer - the one-piece case seems to contain the RFI trash
  645.      better within the computer.  The other suggestion is to use shielded
  646.      cables on your serial and parallel ports.
  647.      
  648.      PROGRAM SUPPORT
  649.   
  650.      This program was written simply because K8CC wanted to embrace the
  651.      concept of the paperless contest in all of his endeavors.  It is not
  652.      intended to compete with, nor take away from, the fine K1EA program,
  653.      which is for a different set of contests.
  654.   
  655.      K8CC will continue to support and improve the code.  There is no
  656.      registration fee, nor automatic updates. If you would like a copy of
  657.      the latest version of NA, send a formatted 5-1/4 floppy disk and a
  658.      self-addressed/stamped floppy disk mailer to:
  659.   
  660.      David Pruett, K8CC
  661.      2727 Harris Road
  662.      Ypsilanti, MI 48198
  663.      home:   (313) 481-0755
  664.      office: (313) 493-2168
  665.  
  666.      Don't count on K8CC answering your questions during a contest!!
  667.   
  668.      If you use the program, K8CC is VERY interested in your problems,
  669.      comments and suggestions.  One goal for this program is to enhance the
  670.      level of participation in the contests which it supports - feel free to
  671.      share the disk with others.
  672.   
  673.      73,
  674.   
  675.      Dave Pruett, K8CC
  676.  
  677.      REVISION HISTORY;
  678.   
  679.      Rev 1.0 - Initial version, used in the 2/89 NA Sprint by K8CC
  680.   
  681.      Rev 2.0 - Major revision, first version to be distributed
  682.      *   NA QSO Party support added, with all of its implications
  683.      *   Band-Multiplier (alt-M) display added, "NEEDED" now alt-N
  684.      *   Dupe check (F9) enhanced to show worked-before QSOs
  685.      *   "Multiplier Guess" added for VE and NA DX QSOs
  686.      *   Check last QTH for mult (F10) function added
  687.      *   Kill line (ctrl-K) edit function added
  688.      *   Keyer control added via printer port
  689.      *   Check Partial now flags call only once, dark for current band
  690.      *   "Valid Call" checking added
  691.      *   "Unique Call" list added
  692.   
  693.      Rev 2.11
  694.      *   Rev'd file retrieval for improved speed
  695.      *   Fixed ctrl-K description in help screen
  696.      *   Increased array size to 2300 QSOs (complier limitation)
  697.  
  698.      Rev 2.15
  699.      *   Added HOME key for start-of-field goto besides ctrl-A
  700.      *   Revised Wisconsin abbreviation to WI
  701.      *   Monochrome/Hercules bug fixed, mono/color now sensed automatically
  702.  
  703.      Rev 2.20
  704.      *   Revised data entry methodology
  705.  
  706.      Rev 2.30
  707.      *   Program sends CW thru COM ports a la K1EA
  708.  
  709.      Rev 3.0 - Major revision, used in 1989 IARU by K8CC & KR0Y
  710.      *   IARU HF Championship now supported
  711.      *   "Reference Rate Sheet" feature (Alt-R) added
  712.      *   Mult Abbreviation now part of multi-function window (Alt-A)
  713.      *   File structure modified for random access, N2A & A2N utils added
  714.      *   Keyer memories saved in data file
  715.      *   DGROUP memory problem fixed
  716.      *   LPT1 now used for SSB voice keyer control
  717.  
  718.      Rev 3.04 - Reflecting post-IARU comments
  719.      *   File loading speed improved (now tolerable!!)
  720.      *   Space bar works like tab key in Logging Screen - tnx KM9P
  721.      *   Manual entry/edit of zone made no/wrong QSO points - fixed
  722.      *   Leading portables assumed to be invalid - fixed
  723.      *   F5 would not send current call without <CR> - fixed
  724.      *   Abort process rev'd to "C/E/W" (allows abort of abort!)
  725.      *   File directory added to startup screen
  726.  
  727.      Rev 4.0 - Major revision
  728.      *   ARRL Sweepstakes now supported
  729.      *   QSO capacity now 2619 QSOs (compiler limitation)
  730.      *   Sent-QSO-number ambiguities for NAS/SS fixed
  731.      *   Changes due to editing a QSO are now reflected in subsequent QSOs
  732.      *   Memory #6 is now programmable (assumed to be QSO B4 message)
  733.      *   "Stop Keyer" key now "esc" (was ctrl-C)
  734.      *   AutoDupe feature added
  735.  
  736.      REVISION HISTORY (continued)
  737.  
  738.      Rev 4.02 - Reflecting post-Sept 1989 Sprint comments
  739.      *   Keyboard handler now operates in INSERT mode - tnx KM9P & N2IC
  740.      *   END key moves to end of data in field
  741.      *   Band change keys revised to: (+) = band up, (-) = band down
  742.      *   Band changes can now be done in any field
  743.      *   Confirming <CR> no longer required when editing
  744.      *   Partial QTH now allowed until QSO is logged - tnx N2IC
  745.      *   DX counted as NA mult in error after editing previous QSO - fixed
  746.      *   Exiting empty NR or QTH fields after ctrl-W would crash - fixed
  747.  
  748.      Rev 4.03 - Minor bug fixes
  749.      *   Alt-F1/Alt-F2 restored for bandchanging w/funny keyboards - tnx K5ZD
  750.      *   Received number and check fields now checked for validity
  751.      *   Shift-tab moves backwards one field - tnx K5ZD
  752.      *   F9/F10 functions now work in any field - tnx KM9P
  753.      *   Mult lists are now insensitive to upper/lower case
  754.      *   Log is marked if bad QTH is read (existing file)
  755.      *   DX QSOs not allowed in SS (but OK for NAS/NAQP)
  756.  
  757.      Rev 4.04
  758.      *   (*) key for log/QRZ was busted, now fixed - tnx KE8OC
  759.  
  760.      Rev 4.05 - Reflecting post-1989 CW SS comments
  761.      *   PgUp and PgDn keys now page through log file for editing prior QSOs
  762.      *   "/" in call field w/o prefix crashes program, now fixed - tnx WA8RRR
  763.      *   Rate displays now updated every QSO (was based on 10 Q periods)
  764.      *   Revised cursor action for improved visibility
  765.  
  766.      Rev 4.10
  767.      *   ARRL Ten Meter contest now supported
  768.      *   "#" operator added to insert QSO nr in memory #2 for exchange
  769.      *   Cursor goes to spot in field when returning after move - tnx KM9P
  770.      *   Ctrl-G (goto QSO nr) function added
  771.  
  772.      Rev 4.11
  773.      *   Trapping for errors in ARRL.CTY file table added
  774.      *   DX prefix-to-country finder speed improved (affects ARRL 10M)
  775.  
  776.      Rev 4.12 - Reflecting post-1989 ARRL 10M Contest comments
  777.      *   SAVELOG function added to backup log file to A:
  778.      *   QSOs/Mult display changed to Minutes/Mult display - tnx K3LR
  779.      *   Bandchanging after two PgUp's would cause crash - fixed
  780.      *   ARRL 10M Contest bugs fixed:
  781.          - Countries ID'd by four or more digits (ex. UA1N) would not score
  782.            correctly - fixed
  783.          - Non-recognized countries allowed to be worked
  784.          - Score /MM stations as multipliers
  785.          - Editing a call would not erase former country mult from score
  786.          - Canada Maritime (MR) mult split into NB, NS & PEI
  787.  
  788.      Rev 4.13
  789.      *   Country missed in ARRL 10M after completing a partial call - fixed
  790.      *   Output log files improved, all lines include date & band - tnx WN4KKN
  791.      *   Summary file now appears like "official" sheets for each contest
  792.      *   F10 (Check Multiplier) now works for ARRL 10M
  793.  
  794.      Rev 4.14
  795.      *   Cursor could run off top of log field under certain conditions - fixed
  796.  
  797.      REVISION HISTORY (continued)
  798.  
  799.      Rev 4.20
  800.      *   ARRL 160M & CQ 160M contests now supported.
  801.      *   Edit bandchange in NA Sprint would cause crash - fixed
  802.      *   ARRL 10M Contest Novice & Technician CW QSOs now count eight points
  803.      *   PgDN with less than ten QSOs would cause crash - fixed
  804.  
  805.      Rev 4.21
  806.      *   VEs scored as 2 points in CQ 160 contest, should be 5 points - fixed
  807.  
  808.      Rev 4.22
  809.      *   Scoring revision from version 4.21 is OK if you are a W/K, but not
  810.          if you are a VE.  Information Sheet QTH field now determines whether
  811.          you are W/K or VE - it is now fixed correctly (finally!)
  812.      *   District of Columbia erroneously included in CQ160.MLT - now removed
  813.      *   VoiceKeyer support was accidentally busted some time ago - now fixed
  814.  
  815.      Rev 4.23
  816.      *   Some mono monitors would display an empty Information Sheet.  This was
  817.          wierd because both of my mono computers worked OK.  I found a typo in
  818.          the code and it should now be fixed - tnx K3LR, WB3KKX and WB2K
  819.      *   Alt-N was accidentally busted some time ago for IARU - now fixed
  820.      *   Rate window now updates if you scroll back thru file
  821.      *   160m summary sheets showed points in multiplier column.  This was
  822.          coded correctly, but I fell victim to an anomoly in the compiler,
  823.          now fixed - tnx K5ZD
  824.      *   Line for team name added to Sprint summary sheet - tnx K3LR